Hexo+github pages创建个人博客教程(1)

2015-05-23

本教程适用于Hexo3.0。我自己在创建的时候，碰到了许多问题，上网搜索答案花了很多时间，网上很多解答都已经无效，所以我会将如何解决作为我的重点。

#Hexo的安装

1、安装Node.js

w3cschool上的教程很详细，照着安装一下就好了。
Node.js 安装配置

2、安装Hexo

打开cmd，输入

1	$ npm install -g hexo

如果系统的cmd不行，可以使用node.js的控制台。或在系统环境变量Path里加入node.js安装目录。

3、安装Hexo-Server

根据网上其他教程,在执行这个命令过程中，会出现本地服务不能启动。

1	$ hexo server

那是因为Hexo3.0开始将server模块独立出来了。
所以要先安装Hexo-Server模块。一般安装在node_modules下，整个目录在C:\Users\ling\AppData\Roaming\npm\目录下。
可以cd到该目录下安装

1 2	$ cd <hexo_folder> $ npm install <module_2bInstalled> --save

1	$ npm install hexo-server --save

其余独立出来的还包括下面这些

npm install hexo-generator-index –save
npm install hexo-generator-archive –save
npm install hexo-generator-category –save
npm install hexo-generator-tag –save
npm install hexo-server –save
npm install hexo-deployer-git –save
npm install hexo-renderer-marked@0.2 –save
npm install hexo-renderer-stylus@0.2 –save
npm install hexo-generator-feed@1 –save
npm install hexo-generator-sitemap@1 –save

特别是hexo-deployer-git这个模块,不安装的话后面在运行hexo deploy时会提示找不到git,参见这个issues1040.

可以到\node_modules目录下面看自己是不是已经安装了这些模块.

4、初始化Hexo

新建一个Hexo文件夹，运行如下命令

1
2
3

$ hexo init <folder>
$ cd <folder>
$ npm install

完成后，进入新建的Hexo文件夹查看是否初始化成功

5、生成静态文档

在Hexo文件夹下，运行如下命令

1	$ hexo generate

命令成功，会产生一个public文件夹

6、开启本地Server调试

在Hexo文件夹下，运行如下命令

1	$ hexo server

如果这个命令失败了，有可能是没有安装hexo-server模块。回看步骤3安装。

如果开启服务成功，打开localhost:4000则可以在本地看到生成的页面。
接下来就可以上传到github上了。